Ides Calendar

The author and Lithic Software Corporation assume no liability for the use of the Ides Applet. It is distributed without any warrantee of any type.

This applet and the accompanying images may not be distributed for profit or on CD without the express written consent of the copyright holder. The applet and documentation are Copyright 1998 Lithic Software Corporation, all rights reserved. Images copyright John Keogh (keo@lithic.com), who wrote the applet. For updates go to:
http://www.lithic.com/java/java.html

This readme covers the following topics:
Using Ides
Parameters
License
Help/Consulting

Using Ides:
To use the calendar, create pictures that are 220X140 pixels. Name them January.jpg, February.jpg, March.jpg, (this can be modified (see below)). Do not use the pictures that came with the package, they are included for demonstration (all were taken by John Keogh in the Southwestern US). The aspect ratio of the display, 2:1, is the same aspect ratio as most pictures one takes with a camera, but you will need to resize to 220X140 so that the pictures are displayed properly. Load the pictures in the same directory as the applet class files, then use the tag below in your html code. If the applets and images are located in a different directory than the web page, you will need to include a codebase modifier. If you use an image for the background that the calendar is drawn on, it should be 224X124 (if it is another size, it will be resized prior to rendering, which is inefficient).

You can modify the parameters (see parameters), but if you are new to HTML and Java, you may want to just leave them as they are.

An example HTML file, ides.html, is included for demonstration. Internet explorer will not display the images if they are on your hard drive, but most or all versions of Netscape should.

</APPLET>

When you upload this or any applet, you need to use binary mode rather than ASCII mode. Binary mode is the default mode for a lot of FTP clients, so generally just upload as normal. The parameters are discussed below.

There should be a 1:1:1 corresponce between the number of descriptions, links, and dates.

Parameters:

The parameters are briefly discussed below.

<PARAM NAME=dates VALUE="6/12/1998^6/13/1998^6/14/1998^">
The dates are '^' delimited. Note the format: m/d/yyyy. For June 1, 1998, use 6/1/1998. For October 17, 1998 use 10/17/1998. You can use the format m/d for dates that have an annual significance. The list must end with a '^' .

<PARAM NAME=descriptions
VALUE="Update Software Page^Start to distribute ides^Charm hat offer expires^">
These are the descriptions that will appear in the floating labels. They must be short. The delimiter is again '^'. If a ^ occurs in the string, it must be doubled. ^ must not begin or end a string.

<PARAM NAME=links
VALUE="software/software.html^java/ides.html^software/charm.html^">
The delimiter is again '^'. If a ^ occurs in the string, it must be doubled. ^ must not begin or end a string. These strings are added to the url identified below in the root parameter. To link to a site that does not have the same root, use the full url.

There should be a 1:1:1 corresponce between the number of descriptions, links, and dates.

<PARAM NAME=root VALUE="http://www.lithic.com/">
Added to each link that does not start with "http". If all the links will be full urls, use "." here.

<PARAM NAME=target VALUE=".">
Three possibilities. Use "." to point the current browser at the link. Use "new" to create a new instance of the browser and pass it the URL. In a frames environment you can use the name of a frame as the target (be sure to NOT name the target frame "new"). So if your target frame is named "show", use "show" as the target.

<PARAM NAME=Sun VALUE="Sun">
<PARAM NAME=Mon VALUE="Mon">
<PARAM NAME=Tue VALUE="Tue">
<PARAM NAME=Wed VALUE="Wed">
<PARAM NAME=Thu VALUE="Thu">
<PARAM NAME=Fri VALUE="Fri">
<PARAM NAME=Sat VALUE="Sat">
These are the names of the days. If you use a language other than English, you can substitute the appropriate three letters from your language for the defaults.

<PARAM NAME=JanuaryImage VALUE="January.jpg">
<PARAM NAME=FebruaryImage VALUE="February.jpg">
<PARAM NAME=MarchImage VALUE="March.jpg">
<PARAM NAME=AprilImage VALUE="April.jpg">
<PARAM NAME=MayImage VALUE="May.jpg">
<PARAM NAME=JuneImage VALUE="June.jpg">
<PARAM NAME=JulyImage VALUE="July.jpg">
<PARAM NAME=AugustImage VALUE="August.jpg">
<PARAM NAME=SeptemberImage VALUE="September.jpg">
<PARAM NAME=OctoberImage VALUE="October.jpg">
<PARAM NAME=NovemberImage VALUE="November.jpg">
<PARAM NAME=DecemberImage VALUE="December.jpg">
These are the names of the images that will be loaded for the corresponding month. The images must be in the codebase (if you upload everything to the same directory, and do not change the applet tag, that is the codebase). You can change them, but they should be a file name, do not use a URL. To ensure reliable loading, these images should not be very large.

<PARAM NAME=About VALUE="About">
<PARAM NAME=Next VALUE="Next">
<PARAM NAME=Previous VALUE="Previous">
<PARAM NAME=Current VALUE="Current Month">
<PARAM NAME=loading VALUE="Loading Image...">
These values are used to supply the text for the navigation button, and for the text that is displayed when the images are loading.

<PARAM NAME=weekstartsonmonday VALUE="false">
Most Europeans start the week on Monday, so they would set this to true. Americans start the week on Sunday, so leave it false. Everybody else, set appropriately for your locale or audience.

<PARAM NAME=backcolor VALUE="F0F0F0">
<PARAM NAME=calendarimage VALUE="back.jpg">
<PARAM NAME=calendarback VALUE="F0F0F0">
<PARAM NAME=text VALUE="000000">
<PARAM NAME=lines VALUE="909090">
<PARAM NAME=bright VALUE="EEEEEE">
<PARAM NAME=dark VALUE="505050">
The backcolor is the color of the applet background. The calendarback is the color of the calendar background. The lines, bright, and dark parameters are used to draw the lines on the calendar, and to make important dates appear raised. The text parameter is used to set the text color. The calendarimage is used if there is a background image. If there is no background image, use a "." as the value. The file size of the background image should be as small as possible, as the calendar will not render completely until it is downloaded.

The colors must be in hex format, as shown. If you need some help with this format, try the hex color calculator (for Windows 3.1/95) located at:
http://www.lithic.com/software/free.html

If you make a mistake, the default colors of black or white will be used for the lines and background.

License:
Ides must be licensed before being used publicly on the web (please do test ides on the web prior to buying it, but on a test URL), the license fee is $25 US per page where it will appear (generally only one). When you license the applet, you will be sent a license class. You can register by sending a check for $25.00 US to Lithic Software Corporation, P. O. Box 2994, Grand Junction, CO 81502. A receipt will be sent to you via the postal service.

Help/Consulting
For General questions, contact John Keogh at keo@lithic.com. Consulting, help with the parameters, customizing, and programming are available for a fee from Lithic Software Corporation. To contact Lithic Software, email to consulting@lithic.com

If you are interested in getting framed, matted, and signed blowups of some of these photographs, please contact John Keogh at keo@lithic.com.